SaferPluginDateHelpers

La classe SaferPluginDateHelpers fournit des méthodes d'aide pour travailler avec des dates.

Méthodes

extract(string $part, DateTime|string|int|null $date = null): string

public static function extract(string $part, DateTime|string|int|null $date = null): string

Description

Extrait une partie spécifique d'une date.

Paramètres

  • string $part : La partie à extraire (par exemple, 'Y' pour l'année, 'm' pour le mois, 'd' pour le jour).
  • DateTime|string|int|null $date : La date dont extraire la partie. Si null, la date actuelle est utilisée.

Retour

  • string : La partie extraite sous forme de chaîne.

Exemple

$year = SaferPluginDateHelpers::extract('Y'); // Année actuelle
$day = SaferPluginDateHelpers::extract('d', '2024-07-26'); // '26'

toStr(DateTime|string|int|null $date = null, string $format = 'Y-m-d'): string

public static function toStr(DateTime|string|int|null $date = null, string $format = 'Y-m-d'): string

Description

Convertit une date en une représentation sous forme de chaîne.

Paramètres

  • DateTime|string|int|null $date : La date à convertir. Si null, la date actuelle est utilisée.
  • string $format : Le format de la chaîne résultante. Par défaut : 'Y-m-d'.

Retour

  • string : La date sous forme de chaîne dans le format spécifié.

Exemple

$dateStr = SaferPluginDateHelpers::toStr('2024-07-26'); // '2024-07-26'
$formattedDate = SaferPluginDateHelpers::toStr('2024-07-26', 'd/m/Y'); // '26/07/2024'

isPublicHoliday(DateTime|string|int|null $date = null): bool

public static function isPublicHoliday(DateTime|string|int|null $date = null): bool

Description

Vérifie si une date est un jour férié.

Paramètres

  • DateTime|string|int|null $date : La date à vérifier. Si null, la date actuelle est utilisée.

Retour

  • bool : true si la date est un jour férié, false sinon.

Exemple

$isHoliday = SaferPluginDateHelpers::isPublicHoliday('2024-07-26'); // false
$isHoliday = SaferPluginDateHelpers::isPublicHoliday('2024-12-25'); // true

Remarques

  • Les jours fériés vérifiés sont : Jour de l'An, Fête du Travail, Victoire de 1945, Fête Nationale, Assomption, Toussaint, Armistice, Noël, et le Lundi de Pâques.
  • La méthode isPublicHoliday vérifie également le Lundi de Pâques, en calculant la date de Pâques pour l'année donnée.